Node / meshtastic / Meshtastic-Android / files / androidApp / src / google / kotlin / org / meshtastic / app / map / offline / pmtiles / OfflineVectorRenderer.kt

Displaying Raw • Download

T8b949e/*

* Copyright (c) 2026 Meshtastic LLC

*

* This program is free software: you can redistribute it and/or modify

* it under the terms of the GNU General Public License as published by

* the Free Software Foundation, either version 3 of the License, or

* (at your option) any later version.

*

* This program is distributed in the hope that it will be useful,

* but WITHOUT ANY WARRANTY; without even the implied warranty of

* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the

* GNU General Public License for more details.

*

* You should have received a copy of the GNU General Public License

* along with this program. If not, see <https://www.gnu.org/licenses/>.

*/

Tff7b72package T7ee787org.meshtastic.app.map.offline.pmtiles

Tff7b72import T7ee787co.touchlab.kermit.Logger

Tff7b72import T7ee787com.google.android.gms.maps.model.LatLng

Tff7b72import T7ee787com.google.android.gms.maps.model.LatLngBounds

Tff7b72import T7ee787kotlinx.serialization.ExperimentalSerializationApi

Tff7b72import T7ee787kotlinx.serialization.SerializationException

Tff7b72import T7ee787kotlinx.serialization.protobuf.ProtoBuf

T8b949e/** One decoded feature, already placed in real-world coordinates and tagged with the basemap layer it came from. */

Tff7b72internal Tff7b72data Tff7b72class T56d364OfflineFeatureTb4b4b4(Tff7b72val Te6edf3layerNameTb4b4b4: Tffa657StringTb4b4b4, Tff7b72val Te6edf3geometryTypeTb4b4b4: Tffa657IntTb4b4b4, Tff7b72val Te6edf3ringsTb4b4b4: Te6edf3ListTff7b72<Te6edf3ListTff7b72<Te6edf3LatLngTff7b72>Tff7b72>Tb4b4b4)

T8b949e/**

* Decodes an offline region's MVT tiles into drawable geometry, on demand and cached per tile.

*

* Only [RENDERED_LAYERS] are kept — Protomaps' basemap ships ten (boundaries, buildings, earth, landcover, landuse,

* places, pois, roads, transit, water; docs.protomaps.com/basemaps/layers). Buildings and POIs alone can be most of a

* tile's feature count at high zoom, and this offline layer exists to keep the map legible without a network, not to

* reproduce it — water and roads (plus boundaries, cheap and useful for context) are what a evacuation-planning glance

* actually needs.

*

* Every ring MVT hands back — hole or exterior — is drawn as its own independent

* [com.google.maps.android.compose.Polygon]. A real multi-ring-with-holes lake therefore double-draws over its islands

* rather than cutting them out; grouping rings by winding direction into proper polygon/hole sets is deferred (see the

* module README) rather than risked for this pass.

*/

Tff7b72internal Tff7b72class T56d364OfflineVectorRenderer Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3tileCache Tff7b72=

Tff7b72object Tb4b4b4: T56d364LinkedHashMapTff7b72<Tffa657StringTb4b4b4, Te6edf3ListTff7b72<Te6edf3OfflineFeatureTff7b72>Tff7b72>Tb4b4b4(Te6edf3INITIAL_CAPACITYTb4b4b4, Te6edf3LOAD_FACTORTb4b4b4, Tff7b72trueTb4b4b4) Tb4b4b4{

Tff7b72override Tff7b72fun Td2a8ffremoveEldestEntryTb4b4b4(Te6edf3eldestTb4b4b4: Te6edf3MutableMapTb4b4b4.Te6edf3MutableEntryTff7b72<Tffa657StringTb4b4b4, Te6edf3ListTff7b72<Te6edf3OfflineFeatureTff7b72>Tff7b72>Tb4b4b4)Tb4b4b4: Tffa657Boolean Tff7b72=

Te6edf3size Tff7b72> Te6edf3MAX_CACHED_TILES

Tb4b4b4}

T8b949e/** Every rendered-layer feature from the tiles at [zoom] (clamped to what [region] actually has) over [bounds]. */

Tff7b72fun Td2a8fffeaturesForTb4b4b4(

Te6edf3regionTb4b4b4: Te6edf3OfflineRegionTb4b4b4,

Te6edf3archiveTb4b4b4: Te6edf3OfflineVectorArchiveTb4b4b4,

Te6edf3zoomTb4b4b4: Tffa657IntTb4b4b4,

Te6edf3boundsTb4b4b4: Te6edf3LatLngBoundsTb4b4b4,

Tb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineFeatureTff7b72> Tb4b4b4{

Tff7b72val Te6edf3renderZoom Tff7b72= Te6edf3zoomTb4b4b4.Te6edf3coerceInTb4b4b4(Te6edf3regionTb4b4b4.Te6edf3zoomRangeTb4b4b4)

Tff7b72return Te6edf3OfflineRegionTileSetTb4b4b4.Te6edf3tilesTb4b4b4(Te6edf3boundsTb4b4b4, Te6edf3renderZoomTb4b4b4.Tb4b4b4.Te6edf3renderZoomTb4b4b4)Tb4b4b4.Te6edf3flatMap Tb4b4b4{ Te6edf3tile Tff7b72-Tff7b72>

Te6edf3tileFeaturesTb4b4b4(Te6edf3regionTb4b4b4.Te6edf3idTb4b4b4, Te6edf3archiveTb4b4b4, Te6edf3tileTb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tff7b72private Tff7b72fun Td2a8fftileFeaturesTb4b4b4(Te6edf3regionIdTb4b4b4: Tffa657StringTb4b4b4, Te6edf3archiveTb4b4b4: Te6edf3OfflineVectorArchiveTb4b4b4, Te6edf3tileTb4b4b4: Te6edf3TileIndexTb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineFeatureTff7b72> Tb4b4b4{

Tff7b72val Te6edf3key Tff7b72= Ta5d6ff"Tffd700$Te6edf3regionIdTa5d6ff/Tffd700${Te6edf3tileTb4b4b4.Te6edf3zoomTffd700}Ta5d6ff/Tffd700${Te6edf3tileTb4b4b4.Te6edf3xTffd700}Ta5d6ff/Tffd700${Te6edf3tileTb4b4b4.Te6edf3yTffd700}Ta5d6ff"

T8b949e// Access-ordered, so even get() is a structural modification — and a superseded LaunchedEffect's featuresFor

T8b949e// keeps running on the IO dispatcher while the next one starts. Same lock as HillshadeTileProvider's caches.

Te6edf3synchronizedTb4b4b4(Te6edf3tileCacheTb4b4b4) Tb4b4b4{ Te6edf3tileCacheTff7b72[Te6edf3keyTff7b72] Tb4b4b4}

Tff7b72?.Te6edf3let Tb4b4b4{

Tff7b72return Tffa657it

Tb4b4b4}

Tff7b72val Te6edf3bytes Tff7b72= Te6edf3archiveTb4b4b4.Te6edf3readTileTb4b4b4(Te6edf3tileTb4b4b4.Te6edf3zoomTb4b4b4, Te6edf3tileTb4b4b4.Te6edf3xTb4b4b4, Te6edf3tileTb4b4b4.Te6edf3yTb4b4b4)

Tff7b72val Te6edf3decoded Tff7b72= Tff7b72if Tb4b4b4(Te6edf3bytes Tff7b72=Tff7b72= Tff7b72nullTb4b4b4) Te6edf3emptyListTb4b4b4(Tb4b4b4) Tff7b72else Te6edf3decodeTileTb4b4b4(Te6edf3tileTb4b4b4, Te6edf3bytesTb4b4b4)

Te6edf3synchronizedTb4b4b4(Te6edf3tileCacheTb4b4b4) Tb4b4b4{ Te6edf3tileCacheTff7b72[Te6edf3keyTff7b72] Tff7b72= Te6edf3decoded Tb4b4b4}

Tff7b72return Te6edf3decoded

Tb4b4b4}

Tf0883e@OptInTb4b4b4(Te6edf3ExperimentalSerializationApiTff7b72::Te6edf3classTb4b4b4)

Tf0883e@SuppressTb4b4b4(Ta5d6ff"Ta5d6ffdetekt:UnreachableCodeTa5d6ff"Tb4b4b4)

Tff7b72private Tff7b72fun Td2a8ffdecodeTileTb4b4b4(Te6edf3tileTb4b4b4: Te6edf3TileIndexTb4b4b4, Te6edf3bytesTb4b4b4: Te6edf3ByteArrayTb4b4b4)Tb4b4b4: Te6edf3ListTff7b72<Te6edf3OfflineFeatureTff7b72> Tb4b4b4{

Tff7b72val Te6edf3vectorTile Tff7b72=

Tff7b72try Tb4b4b4{

Te6edf3ProtoBufTb4b4b4.Te6edf3decodeFromByteArrayTb4b4b4(Te6edf3VectorTileTb4b4b4.Te6edf3serializerTb4b4b4(Tb4b4b4)Tb4b4b4, Te6edf3bytesTb4b4b4)

Tb4b4b4} Tff7b72catch Tb4b4b4(Te6edf3eTb4b4b4: Te6edf3SerializationExceptionTb4b4b4) Tb4b4b4{

T8b949e// No tile coordinates in the message: zoom/x/y is location-adjacent data (AGENTS.md Privacy First).

Te6edf3LOGTb4b4b4.Te6edf3wTb4b4b4(Te6edf3eTb4b4b4) Tb4b4b4{ Ta5d6ff"Ta5d6ffMalformed MVT tileTa5d6ff" Tb4b4b4}

Tff7b72return Te6edf3emptyListTb4b4b4(Tb4b4b4)

Tb4b4b4}

Tff7b72return Te6edf3vectorTileTb4b4b4.Te6edf3layers

Tb4b4b4.Te6edf3filter Tb4b4b4{ Tffa657itTb4b4b4.Te6edf3name Tff7b72in Te6edf3RENDERED_LAYERS Tb4b4b4}

Tb4b4b4.Te6edf3flatMap Tb4b4b4{ Te6edf3layer Tff7b72-Tff7b72>

Te6edf3layerTb4b4b4.Te6edf3featuresTb4b4b4.Te6edf3mapNotNull Tb4b4b4{ Te6edf3feature Tff7b72-Tff7b72>

Tff7b72val Te6edf3localRings Tff7b72= Te6edf3MvtDecoderTb4b4b4.Te6edf3decodeGeometryTb4b4b4(Te6edf3featureTb4b4b4.Te6edf3typeTb4b4b4, Te6edf3featureTb4b4b4.Te6edf3geometryTb4b4b4)

Tff7b72if Tb4b4b4(Te6edf3localRingsTb4b4b4.Te6edf3isEmptyTb4b4b4(Tb4b4b4)Tb4b4b4) Tb4b4b4{

Tff7b72null

Tb4b4b4} Tff7b72else Tb4b4b4{

Te6edf3OfflineFeatureTb4b4b4(

Te6edf3layerName Tff7b72= Te6edf3layerTb4b4b4.Te6edf3nameTb4b4b4,

Te6edf3geometryType Tff7b72= Te6edf3featureTb4b4b4.Te6edf3typeTb4b4b4,

Te6edf3rings Tff7b72=

Te6edf3localRingsTb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3ring Tff7b72-Tff7b72>

Te6edf3ringTb4b4b4.Te6edf3map Tb4b4b4{ Te6edf3local Tff7b72-Tff7b72>

Te6edf3WebMercatorTileMathTb4b4b4.Te6edf3tileLocalToLatLngTb4b4b4(Te6edf3tileTb4b4b4, Te6edf3layerTb4b4b4.Te6edf3extentTb4b4b4, Te6edf3localTb4b4b4)

Tb4b4b4}

Tb4b4b4}Tb4b4b4,

Tb4b4b4)

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tb4b4b4}

Tff7b72internal Tff7b72companion Tff7b72object Tb4b4b4{

Tff7b72private Tff7b72val Te6edf3LOG Tff7b72= Te6edf3LoggerTb4b4b4.Te6edf3withTagTb4b4b4(Ta5d6ff"Ta5d6ffOfflineVectorRendererTa5d6ff"Tb4b4b4)

Tff7b72val Te6edf3RENDERED_LAYERS Tff7b72= Te6edf3setOfTb4b4b4(Ta5d6ff"Ta5d6ffwaterTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffroadsTa5d6ff"Tb4b4b4, Ta5d6ff"Ta5d6ffboundariesTa5d6ff"Tb4b4b4)

Tff7b72private Tff7b72const Tff7b72val Te6edf3MAX_CACHED_TILES Tff7b72= T79c0ff9T79c0ff6

Tff7b72private Tff7b72const Tff7b72val Te6edf3INITIAL_CAPACITY Tff7b72= T79c0ff1T79c0ff6

Tff7b72private Tff7b72const Tff7b72val Te6edf3LOAD_FACTOR Tff7b72= T79c0ff0.75f

Tb4b4b4}

Tb4b4b4}